跳到主要内容

plugin 与 agent 生态

plugin 打包分发、自定义 subagent 定义与跨工具 AGENTS.md 标准的现状

核心要点：

  • plugin 打包 skill/hook/MCP/agent 分发
  • marketplace 分官方/社区/私有
  • 自定义 subagent 用 frontmatter 定义角色/工具/model
  • AGENTS.md 是跨工具约定，Linux Foundation 治理
  • 跨工具互操作正在形成

本文讲生态层的打包与分发。被打包的 skill/hook 机制见 02-skill系统 和 03-hook系统。

plugin 打包什么、怎么分发？​

核心问题：写好的 skill、hook、MCP 配置，怎么打包给别人用？

plugin 是自包含目录，把 skill、agent、hook、MCP server 等组件打包，通过 marketplace 分发[1]。它用 plugin.json manifest 声明 name（决定命名空间）、version、author 等元数据。

分发分三级 marketplace:

  • 官方（随 Claude Code 自动可用）：精选插件，涵盖 LSP、外部集成、安全审查。
  • 社区：第三方提交，安全扫描后 pin commit SHA 发布。
  • 私有：企业在私有 git 仓库建，通过配置字段推给团队。

可借鉴的设计：plugin 把分散的扩展（skill/hook/MCP/命令）收敛成一个可版本化、可分发的单元——这是 agent 能力从"个人配置"走向"可共享生态"的关键。

自定义 subagent 怎么定义？​

核心问题：想要一个只做某类任务的专用 agent，怎么配？

用 Markdown + YAML frontmatter 定义 subagent 的角色、工具集、模型[2]。它把"一个专用 agent"变成一个可声明、可分发的文件。

核心字段：

  • description：触发条件。
  • tools / disallowedTools：工具白名单/黑名单。
  • model：按任务路由到不同档模型(呼应 02-上下文工程/05-token-经济学 的 model routing)。
  • isolation: worktree：隔离执行。

存在 .claude/agents/（项目级、可 git 共享）或全局目录，也可通过 plugin 打包分发。这与 05-工具系统/05 的 subagent-as-tool 是同一对象的两个视角——那里讲"当工具调用"，这里讲"作为生态扩展定义"。

AGENTS.md 是什么，和 CLAUDE.md 啥关系？​

核心问题：每个 agent 工具都有自己的指令文件，能不能统一？

AGENTS.md 是工具无关的项目约定文件，目标是跨工具可移植[3]。它由 OpenAI Codex、Amp、Google Jules 等多方协作发布（2025 年），后移交 Linux Foundation 治理，被 20+ 工具支持、逾 6 万开源仓库采用。

与 CLAUDE.md 的关系是 fallback:Claude Code 在没有 CLAUDE.md 时把 AGENTS.md 当后备(CLAUDE.md 的文件型记忆角色见 03-记忆系统/04)。AGENTS.md 解决的是同一个项目被多种 agent 工具使用时，不必为每个工具各写一份指令。可借鉴的趋势：agent 配置正在从厂商专属走向跨工具标准。

跨工具生态在往哪走？​

核心问题：这些扩展机制的尽头是什么形态？

走向跨工具互操作：各工具开始读取彼此的配置目录，可移植性正在形成[3]。例如有的工具已开始读 .claude/agents/ 下的 subagent 定义。

标准化的三条线索：Agent Skills 成为跨工具标准(02-skill系统)、AGENTS.md 进入中立基金会治理、配置目录互读。可借鉴的判断：为 agent 写扩展时优先用正在标准化的格式(skill、AGENTS.md)，降低被单一厂商锁定的风险。但标准仍在演进，跨工具兼容尚未完全成熟。

Takeaway​

知识点核心结论
plugin打包 skill/hook/MCP/agent 成可版本化分发单元
marketplace官方（精选）/ 社区（扫描 pin SHA）/ 私有（企业 git）
自定义 subagentfrontmatter 声明角色/工具/model/隔离，可 git 共享
AGENTS.md工具无关约定，Linux Foundation 治理，CLAUDE.md 的 fallback
生态趋势跨工具配置互读，优先用标准化格式避免锁定

参考资料​

  1. Anthropic. Create plugins / Discover prebuilt plugins. Claude Code Docs, 2025. https://code.claude.com/docs/en/plugins
  2. Anthropic. Create custom subagents. Claude Code Docs, 2025. https://code.claude.com/docs/en/sub-agents
  3. AGENTS.md: Open standard for agent instruction files. 2025. https://agents.md

延伸阅读​